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1. INTRODUCTION 


1 


i 

The Floppy Disk Utility controls the transfer of programs from the hard disk 
to the floppy disk and vice versa^ It will also copy the data on a floppy 
disk to another floppy disk and compare the data of two floppy disks. 

The program operates under the Data Generali N0VA-4X Real Time Disk Operating 
System (RDOS). 





I i‘ 




2, OPERATOR INTERFACE 


the operator controls the transfer of data via Inputs from the Cathode Ray 
Jube (CRT) keyboard* (Or any system console device.) 


the programs request operator Input by displaying an exclamation mark (!). 
the operator responds with a string of control characters which direct the 
programs to perform an operation. Additional input, necessary to perform 
the operation, is requested via displays on the CRT. 


the operations and the operator interface are described below. Operator in- 
put is underlined. 


2.1 DISPLAY MENU 
JM 


the commands and their functions are displayed. (See Appendix A for a sample 
of the display.) 


2.2 UNIT 
!U 






K' > 


UNIT (0-1) u U 


, The current floppy unit is u. The operator may change units by typing a 0 or 
1. If the operator responds with a carriage return and no unit value, the 
unit remains the same. 


Also, these operations cause the floppy unit u updated program directories to 
be copied out of, unit u, if necessary. The unit need not be changed to cause 
the copy. (See Appendix B for a description of the program directories.) 
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»» 

h 

2.3 DISPLAY PROGRAM DIRECTORY j 

j 

r - 1 

IP 


The program directories for the current floppy are displayed one directory at 
aitime, beginning with program directory 0. Pressing carriage return termin^ 
ates the display. Pressing any other key causes the next directory to be 
displayed. If there are no more directories, the display is terminated. 

(See Appendix B for a description of th& directories.) 


2.4 READ FLOPPY PROGRAM FILE 

r 

PROGRAM NUMBER p P 

Where: p is the current program number. 

£ is the operator response. 

'' Carriage return will cause program file p to be read. 

A numeric response (0-9) will cause the specified 
file to be read. Any other response will cause a 
question mark (?) to be displayed and the operation * 
terminated. 

If the program file is not defined on the floppy, the message 
. UNDEFINED PROGRAM 

Is displayed. The operation will be terminated. 

If a status error is detected, the message, STATUS, the unit number, and the 
status code is displayed (octal format). The operation is terminated. 
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2,5 WRITE FLOPPY PROGRAM FILE 
IWF 

Pf|06RAM NUMBER P P 

FljoPPY PROGRAM NAME xxxxxx 

START ADDRESS * i . 

END address e £ 

Where: p Is the current program number. 

£ is a carriage return if the program file to be written 
is p or a digit (0-9) if another program is to be written, 
xxxxx is the program name terminated by a carriage return or 
the input of 12 alphanumeric characters, 
s is the start (low) address of the program. If the program 
was read from hard disk, s is zero (0). If the program was 
read from the floppy disk, s is taken from the program 
directory, 

£ is a carriage return if s is the start address. Otherwise 
it is an octal value terminated by a carriage return, 
e is the end (high) address. , It is taken from word 404g (JJMAX) 
of the file if the program was read from the hard disk. If 
the program was read from the floppy disk, the end address 
is taken from the program directory. 

£ is a carriage return if e is the end address. Otherwise, to 
set another end address, £ is an octal number terminated by 
a carriage return. 

If no program is in core, the message 

NO PROGRAM 

is displayed when the "W" of the command is input. 
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If the preceding program file number has not been defined In the current 
floppy unit's directory, the message * 

I 

NONCONTIGUOUS FILE 

will be displayed and the operation terminated. 

If during the write operation an error Is detected, the message, STATUS, 
the unit number, and the flpppy disk status are displayed (octal format), 
WARNING: All higher numbered files will be deleted after a WF command! 

2.6 READ HARD DISK FILE 
IRD 

DISK FILE NAME xxxxx 

Where: xxxxx Is blank or the previous hard disk file name processed. 

Appropriate operator response Is a return to read file xxxxx or a file name 
terminated by a carriage return. (The file name must be compatible with RDOS 
conventions.) * 

i 

I 

I ■ ' 

If an error occurs during the read operation, a question mark and the RDOS 
error code are displayed. (See Appendix C for the RDOS error codes.) 

2.7 WRITE HARD DISK FILE 
IWD 

DISK FILE NAME xxxxx 

Where: xxxxx is blank or the name of the previous hard disk 
file processed. 


’ /Appropriate operator response is a return if the file to be written is xxxxx 
or a file name terminated by a return. To be written, the file must not be 

defined when this command is given. To delete a file see DELETE HARD DISK 
FILE (Section 2.10)^ If an error is detected, a question mark and the RDOS 
error code are displayed, (See Appendix C for the RDOS error codes.) 

If no program is in core, the message 

NO PROGRAM 

is displayed when the character "W is input by the user. 

2.8 FORMAT AND WRITE BOOTSTRAP LOADER 
IfO 

The floppy on unit u is formatted. If a status error occurs during formatting 
the process is terminated, the message STATUS, the unit number, and the status 
are displayed. 

If formatting is successful, the name^of the hard disk bootstrap loader^file 
is requested by 

DISK. FILE NAME xxxxx 

Where: xxxxx is blank or the previous program request. 

The appropriate operator response is a return if xxxxx is the name of the 
bootstrap loader file. If it is not the name of the file, the operator should 
respond with the name followed by a return. 

If the file cannot be read from the hard disk, a question mark and the RDOS 
error code are displayed. (See* Appendix C for the RDOS error codes.) If an 
error occurs during the floppy write operation, the message, STATUS, the 
number of the offending unit, and the status are displayed (octal format), 
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Any programs read into core from a floppy or hard disk before the format oper 
atlon are not available for transfer to the floppy or hard disk, 

2.9 EilJ ' 


This command copies the updated directory, if necessary, onto the current 
unit and exits to RODS. 

lODPV disk should not be removed from the drive until this command is 


executed because of the potential for losino the updated director 


2.10 DELETE HARD DISK FILE 


DISK FILE NAME xxxxx 

Where: xxxxx is blank or the name of the previous hard 
disk file processed. 

Appropriate response is a return if xxxxx is the file to be deleted or the 
name of the file terminated by a return. 

If the file cannot be deleted, a question mark and the RDOS error code are 
displayed. (See Appendix C for the RDOS error codes.) 

2.11 COPY 


INPUT 

UNIT (0-1) 



Where! u Is the current unit 

U Is either a carriage return or a 0 or 1. If U Is a 
carriage return, u will be the Input unit. If JU Is 
a 0, or 1 then U Is the Input unit. The other unit 
Is the output unit. Any other response from the 
operator will cause a question mark to be displayed 

and the operation terminated. 

* 

The output unit Is formatted and the data on the Input unit Is copied from 
the Input unit onto the output unit. All 76 tracks are copied. If an error 
Is detected, the message, STATUS, the number of the offending unit, and the 
unit status are displayed. The operation Is terminated. 

Since all 76 tracks are copied, the data need not be In Data Systems Labora- 
tory Floppy (DSLF) Format, 

2,12 VERIFY 
IV 

VERIFY ALL TRACKS - YES (Y), MO (N) Y , 

or 

IV 

VERIFY ALL TRACKS - YES (Y), MO (N) N 
UNIT 0 

PROGRAM NUMBER Pg Pq 

UNIT 1 

PROGRAM NUMBER Pj f ^ 

In the first case, all 26 tracks of unit 0 are compared with all 26 tracks of 
unit 1, Therefore, the floppy disk need not be In DSLF format. 
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In the second case, the specified program dati on unit 0 is compared with the 
specified program of unit 1. The data of both floppy disks must be in OSLF 
format. If the two programs do not occupy the same number of tracks the 
error message 

«. « 

PROGRAM LENGTH 


is displayed and the operation is terminated. 

In both cases if an error is detected during the compare, the format of the 
error message is as follows: 


Where: Tq is the unit 0 track number 

Wq is the unit 0 word number with the track (0-3177) 

Pq is the unit 0 data word in error 

T 2 is the unit 1 track number 

D| is the unit 1 data word in error 

All displays are in octal, ^ 

When an error is displayed, the verification process is halted awaiting an 
operator response. Appropriate responses are: 

Carriage return terminates verification. 

Line feed causes the verification to be continued with the next track. 
Any other character causes verification to be continued with the next 
word. 

2.13 . WRITE BOOTSTRAP LOADER ON THE FLOPPY 
IL 
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DISK FILE NAME xxxxx 

t 

I 

I 

Where: xxxxx Is blank or the hard disk file name of the previous 
program read from hard disk. 

Appropriate operator response Is a return If xxxxx Is the hard disk file name 
of the bootstrap loader or the file name of the bootstrap loader terminated 
by a return. 

If. the file cannot be read, a question mark and the RDOS error code are dis- 
played. (See Appendix C for the RDOS error codes.) If an error occurs 
during the floppy write operation, the message, STATUS, the unit number, and 
the floppy status are displayed (octal format). 
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3. OPERATING INSTRUCTIONS • 

! 

Thei Floppy Disk Utility is in directory DPOF;AKEKSOF. The name of the pro 
gram is FLQPM. ' 


Samples of common operations are illustrated in Appendix D. 





APPENDIX A 

FLOPPY DISK UTILITY COMMANDS 



APPENDIX A 

FLOPPY DISK UTILITY COMMANDS 

MENU M 

UNIT U 

DISPLAY DIRECTORY » . . P 

READ FLOPPY RF 

WRITE FLOPPY WF 

READ DISK Rt 

WRITE DISK WC 

FORMAT FLOPPY. FC 

EXIT X 

DELETE DISK FILE D 

COPY C 

VERIFY V 

LOADER . L 


* i7 
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APPENDIX B 

DATA SYSTEMS LABORATORY FLOPPY (DSLF) FORMAT 


•» ' 

The program data stored on the disk will consist oT a bootstrap load program, 
the program directories, and the program data. 


The bootstrap loader occupies track 0, sector 1 through track 1, sector 15g. 


The program directories occupy track 1, sector 16g through track 1, sector 
27g. The directories define each program, its location on the floppy, and 
its core memory starting (low) address and stop (high) address,. Each direc- 
tory occupies one sector. The format of the directories Is as follows. 


WORD 
0 - 11 


12 

13 

14 - 21 


22 

t 

23 

24 

25 

26 


- 64 


Program file name - one character per word right . 
justified 

start (low) address 
stop (high) address 

date - one character per word right justified. The 
format of the date is as follows. MM/DD/YY Where* 
Mm is the number of the month, DD is the day of the 
fijonth, YY is the year. 

I 

sitart track of the program file 
rjumber of the tracks in the file 
last track of the program file 
next available track (last track + 1) 

Zero 


Program files begin at track 2, sector 1. Each file begins at the track 
boundary, I.e., sector 1. 
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APPENDIX C 

* 

RODS ERROR CODES 

The following describes the RDOS error codes that may occur during operation 
of the Floppy Disk Utility program. A more complete description of the 
errors is in the Data General document, Real Time Disk Operation System (RDOS) 
Reference Manual, 


ERROR CODE 
1 

‘ 7 

10 

11 

12 
13 


52 

101 


DESCRIPTION 

Illegal file name (only alphanumeric or $ characters 
are permitted) 

The file is read protected 
The file is write protected 

t 

The file already exists 
The file does not exist 

i 

The file cannot be deleted because it has the 
permanent attribute 
Illegal directory specifier 
Disk timeout occurred 
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APPENDIX D 
SAMPLE OPERATIONS 
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APPENDIX D 
SAMPLE OPERATIONS 
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Below are given two examples that Illustrate the major uses of the floppy disk 
utility. Operator input is underlined, and carriage return is represented 

by^. 

V 

Copy hard disk file, MONIT.SV onto the floppy disk unit 1, program file 1. 


iU 

UNIT (0-1) 0 i 

!RD 

DISK FILE NAME 
MONIT.SV 
IMF 

PROGRAM NUMBER 0 1 

FLOPPY PROGRAM NAME MONITOR P 

START ADDRESS 000000 I 
STOP ADDRESS 012517 ^ 

IX 

R 


0-1 




4 * V % 


Copy floppy disk unit 1, program number 1 onto unit 0, program number 3. 
Verify the transfer. 


lU 

uriiT (0-1) 0 1 

!R| 

PROGRAM NUMBER 0 I 

!U 

UNIT (0 - 1) 10 

IW| 

PROGRAM NUMBER 1 3 

FtOPPY PROGRAM NAME MONITOR p 

• START ADDRESS 000000 £ 
stop ADDRESS 012517 £ 

ivi 

VERIFY ALL TRACKS YES (Y), NO (N) 
UNIT 0 

PROGRAM NUMBER 3 £ 

UjllT 1 

PROGRAM NUMBER 3 I 

IX 


r 


i 
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